home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -in_the_mag- / cologne / mpegagui / mp3tool.doc < prev    next >
Text File  |  1997-12-06  |  5KB  |  223 lines
  1. Introduction
  2. ------------
  3.  
  4. MP3Tool is a tool to get and set information from/to an MPEG Audio file. MPEG Audio
  5. Layer 3 files may contain a TAG at the end of the file with additional information
  6. on the song. Without that TAG only the 'File', 'Layer', 'BPS' and 'Length' options
  7. can be used. Bear in mind that the existance of a TAG in an MP3 file doesn't always
  8. mean that the information in it is present or correct. I for instance have found
  9. several MP3 files on the internet which had only the 'Title', 'Artist', 'Album' and
  10. 'Genre' fields filled in. Making a query for the 'Year' on such a file fails,
  11. ofcourse.
  12.  
  13. I recommend using TAGEdit supplied with this tool. It is a Gui4CLI interface for
  14. MP3Tool, which, should you want to, can be adapted to your own needs.
  15.  
  16. Gui4CLI can be downloaded from AmiNet from the directory dev/gui.
  17.  
  18.  
  19. I can be reached at 1011071@ibk.fnt.hvu.nl if you have any comments, bugreports
  20. or suggestions.
  21.  
  22. Copyright 1997 M. van Dillen.
  23.  
  24.  
  25.  
  26.  
  27. Usage
  28. -----
  29.  
  30. FILE/A,TITLE/S,ARTIST/S,ALBUM/S,YEAR/S,COMMENT/S,GENRE/S,LAYER/S,BPS/S,LENGTH/S,
  31.   DURATION/S,NA/K,LFORMAT/K,T/K,AR/K,AL/K,Y/K,C/K,G/K,WRITE/S
  32.  
  33.  
  34. General:
  35.  
  36. FILE     The MPEG filename                                          (required)
  37.  
  38. Query options:
  39.  
  40. TITLE    The title of the song                                      (switch)
  41. ARTIST   The artist/band of the song                                (switch)
  42. ALBUM    The album the song was released on                         (switch)
  43. YEAR     The year the song was released                             (switch)
  44. COMMENT  The extra comment on the song                              (switch)
  45. GENRE    The genre of the song                                      (switch)
  46. LAYER    The version of the layer of the MPEG file                  (switch)
  47. BPS      Number of bits per second with which the song was encoded  (switch)
  48. LENGTH   Playtime of song in seconds                                (switch)
  49. DURATION Playtime in Minutes:seconds format                         (switch)
  50. NA       The string printed if requested item is Not Available      (keyword)
  51. LFORMAT  Alternative output string (see below)                      (keyword)
  52.  
  53. Input options:
  54.  
  55. T        New title of the song                                      (keyword)
  56. AR       New artist/band of the song                                (keyword)
  57. AL       New album the song was released on                         (keyword)
  58. Y        New year the song was released                             (keyword)
  59. C        New comment on the song                                    (keyword)
  60. G        New genre of the song (see below)                          (keyword)
  61. WRITE    Write the new info to the MP3 file                         (switch)
  62.  
  63.  
  64. The limit of the input strings is 30 characters, of the year string 4.
  65. If you enter a longer string it will be truncated.
  66.  
  67.  
  68.  
  69. LFORMAT format
  70. --------------
  71.  
  72. LFormat can be used to customize the output of MP3Tool. The available options are:
  73.  
  74.  
  75. %f  Filename
  76.  
  77. %l  Layer
  78.  
  79. %b  BPS
  80.  
  81. %e  Length
  82.  
  83. %d  Duration
  84.  
  85. %t  Title
  86.  
  87. %a  Artist
  88.  
  89. %u  Album
  90.  
  91. %y  Year
  92.  
  93. %g  Genre
  94.  
  95. %c  Comment
  96.  
  97. \n  Return
  98.  
  99. \-  Underline previous line
  100.  
  101.  
  102.  
  103. Genre format
  104. ------------
  105.  
  106. The 'G' option can be either a number or a string. If you enter a string it must be one
  107. of the following:
  108.  
  109.    Blues
  110.    Classic Rock
  111.    Country
  112.    Dance
  113.    Disco
  114.    Funk
  115.    Grunge
  116.    Hip-Hop
  117.    Jazz
  118.    Metal
  119.    New Age
  120.    Oldies
  121.    Other
  122.    Pop
  123.    R&B
  124.    Rap
  125.    Reggae
  126.    Rock
  127.    Techno
  128.    Industrial
  129.    Alternative
  130.    Ska
  131.    Death Metal
  132.    Pranks
  133.    Soundtrack
  134.    Euro-Techno
  135.    Ambient
  136.    Trip-Hop
  137.    Vocal
  138.    Jazz+Funk
  139.    Fusion
  140.    Trance
  141.    Classical
  142.    Instrumental
  143.    Acid
  144.    House
  145.    Game
  146.    Sound Clip
  147.    Gospel
  148.    Noise
  149.    AlternRock
  150.    Bass
  151.    Soul
  152.    Punk
  153.    Unknown
  154.  
  155. If you enter a number it must be one in the range from 0 (Blues) to 44 (Unknown).
  156.  
  157.  
  158.  
  159. Examples
  160. --------
  161.  
  162. MP3Tool ?
  163.    Shows the AmigaDOS template
  164.  
  165.  
  166. MP3Tool MP3:MP3.Glycerine title artist
  167.    Shows:
  168.           MP3:MP3.Glycerine, Title : Glycerine, Artist : Bush
  169.  
  170.  
  171. MP3Tool MP3:MP3.Glycerine lformat "%t - %a, Layer %l, %b BPS"
  172.    Shows:
  173.           Glycerine - Bush, Layer 3, 131072 BPS
  174.  
  175.  
  176. MP3Tool MP3:MP3.Glycerine lformat "%f\n\-\nTitle:    %t\nDuration: %d (%e seconds)"
  177.    Shows:
  178.           MP3:MP3.Glycerine
  179.           -----------------
  180.           Title:    Glycerine
  181.           Duration: 4:26 (266 seconds)
  182.  
  183.  
  184. MP3Tool MP3:MP3.Forgiven t Forgive ar "Alanis Morissette" write
  185.  
  186.    Writes a TAG at the end of the file MP3:MP3.Forgiven with the Title and Artist
  187.    information in it.
  188.  
  189.  
  190. MP3Tool MP3:MP3.Forgiven write t Forgiven al "Jagged Little Pill"
  191.  
  192.    Updates the TAG at the end of the file MP3:MP3.Forgiven with the correct Title
  193.    and the Album information.
  194.  
  195.  
  196. MP3Tool MP3:MP3.SellingTheDrama g rock write
  197.  
  198.    Updates the TAG at the end of the file MP3:MP3.SellingTheDrama with the Genre.
  199.  
  200.  
  201.  
  202. Credits
  203. -------
  204.  
  205. I looked at MP3Info from Thorvald Natvig <xeno@mix.hive.no> for the TAG structure,
  206. the genres list and the MP3 Header info.
  207. Altough MP3Info seems like a good tool to me, I didn't have the right version of
  208. ixemul.library to check it out.
  209. Anyway, my MP3Tool is more Amiga style, especially the commandline arguments.
  210.  
  211. ID3 Tag Protocol (c) 1997 Eric Kemp <NamkraD> / Damaged Cybernetics
  212. (erick@marble.net) http://www.marble.net/~erick/mpeg3.htm
  213.  
  214.  
  215.  
  216. Contact
  217. -------
  218.  
  219. I can be reached at 1011071@ibk.fnt.hvu.nl if you have any comments, bugreports
  220. or suggestions.
  221.  
  222. Copyright 1997 M. van Dillen.
  223.